home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / toddy211.zip / TODDY.DOC < prev   
Text File  |  1990-04-07  |  12KB  |  310 lines
  1.  
  2.                                       Toddy
  3.                                   Version 2.11
  4.                                   April 6, 1990
  5.  
  6.                        Copyright (c) 1988-1990 Eric Tauck
  7.                                All Rights Reserved
  8.  
  9.      Toddy is a terminate and stay resident (TSR) utility that enhances the
  10.      built-in DOS command line editing and provides a command line scroll-
  11.      back.  Toddy works by trapping the DOS system interrupt (21H) and
  12.      replacing the string input function (0AH).  Only programs using
  13.      function 0AH, like the DOS command processor COMMAND.COM or DEBUG.COM,
  14.      will be affected by Toddy.
  15.  
  16.      The BIOS services are used for reading and writing to the screen and
  17.      should be compatible with most video adapters in both text and
  18.      graphics modes.  DOS is used for reading from the keyboard.
  19.  
  20.                                   Installation
  21.                                   ------------
  22.  
  23.      Toddy is installed by running it from the command line.  The enhanced
  24.      editing capabilities are available upon installation.
  25.  
  26.      Toddy uses a minimum of about 2500 bytes of memory.  The memory
  27.      consumption increases according to the command stack size specified
  28.      when Toddy is installed.
  29.  
  30.      Once installed, Toddy may be disabled with the /RD option and
  31.      reenabled with the /RE option.  This might be useful if an application
  32.      seems to conflict with Toddy.  Toddy may also be removed from memory
  33.      with the uninstall option (/UN).
  34.  
  35.                                      Editing
  36.                                      -------
  37.  
  38.      The enhanced DOS editing commands are available immediately upon
  39.      installation.
  40.  
  41.      The left and right arrow keys may be used to non-destructively move
  42.      the cursor left and right.  Other keys for moving the cursor and
  43.      editing the text are listed in the Command Key section.
  44.  
  45.      Note that the standard DOS editing keys are not implemented.
  46.  
  47.                                   Command Stack
  48.                                   -------------
  49.  
  50.      Each line of input is copied to the command stack for later retrieval.
  51.      If there isn't enough room on the stack, Toddy will delete the oldest
  52.      saved input line to make room.
  53.  
  54.      An input line is not saved to the command stack if it is identical to
  55.      the last saved input line.  Certain options can also be used to
  56.      prevent other types of input lines from being saved.  See the
  57.      descriptions of the /IA, /IL, and /IU options in the Options section.
  58.  
  59.      The up arrow key can be used to recall the last input line.
  60.      Continually pressing the up arrow key will recall progressively older
  61.  
  62.      input lines.  The down arrow key recalls newer input lines, the
  63.      opposite of the up arrow key.  Other keys for scrolling through the
  64.      command stack are listed in the Command Key section.
  65.  
  66.      When traversing the command stack, the stack pointer will wrap from
  67.      the top to the bottom, or from the bottom to the top.
  68.  
  69.                                     Searching
  70.                                     ---------
  71.  
  72.      The command stack can be searched for specific input lines by matching
  73.      the beginning characters.  For instance, if you recently entered a
  74.      long command like:
  75.  
  76.        tcc -v -ms zorro init.obj graflib.lib extra.lib
  77.  
  78.      you can search for this particular input line by typing the first few
  79.      characters, "tcc", and then pressing the Tab key. If there is more
  80.      than one saved input line that begins with "tcc", repeatedly pressing
  81.      Tab will find each occurrence. If there are no more occurrences, an
  82.      empty line will be displayed.  In this case, pressing Escape will
  83.      restore the characters used in the search.
  84.  
  85.      The characters to be used in the search must be entered from the top
  86.      command stack location (i.e. before pressing the up or down arrow
  87.      keys, OR after pressing ^End, OR after a failed search, etc.).
  88.  
  89.                                      Options
  90.                                      -------
  91.  
  92.      Options take affect when Toddy is installed or can be passed to an
  93.      already resident Toddy with the /RS option.  Options can also be
  94.      written to the executable file TODDY.COM with the /WR options so they
  95.      need not be specified the next time Toddy is invoked.
  96.  
  97.      A brief list of the Toddy command line options are displayed to the
  98.      screen by running:
  99.  
  100.        TODDY ?
  101.  
  102.      In the option descriptions, a 'd' denotes a decimal digit and an 'x'
  103.      denotes a hexadecimal digit.  The number of decimal or hexadecimal
  104.      digits serve as only a general reference to the magnitude of the
  105.      number, in most cases fewer or more digits are allowable.
  106.  
  107.      Option descriptions:
  108.  
  109.        /CCxx    Cursor color.  This is the attribute (or color in graphics
  110.                 mode) of the character at the cursor location.  The default
  111.                 is 7.
  112.  
  113.        /CExx    End color.  This is the attribute (or color in graphics
  114.                 mode) of the space after any entered text.  The default is
  115.                 7.
  116.  
  117.        /CTxx    Text color.  This is the attribute (or color in graphics
  118.                 mode) of any entered text to the left or right of the
  119.                 cursor.  The default is 7.
  120.  
  121.  
  122.        /IA      Input all.  Save all input lines to the command stack
  123.                 without checking for uniqueness (reverse of the /IU
  124.                 option).  This is the default.
  125.  
  126.        /II      Insert mode.  New characters are inserted at the location
  127.                 of the cursor without overwriting any characters to the
  128.                 right.  This is the default.
  129.  
  130.        /ILddd   Input length.  If an input line is shorter than the
  131.                 specified length, the input is not saved on the command
  132.                 stack.  This is useful for filtering out trivial commands,
  133.                 like DIR.  The default minimum length is 4.
  134.  
  135.        /IO      Overwrite mode.  Characters to the right of the cursor are
  136.                 overwritten by any new input.
  137.  
  138.        /IS      Insert save.  The insert state, as set by the Insert key or
  139.                 the /II and /IO options, is preserved between inputs.
  140.  
  141.        /IR      Insert reset.  The insert state, as set by the /II and /IO
  142.                 options, is reset with each input. This is the default.
  143.  
  144.        /IU      Input unique.  Saves only unique input lines (i.e.
  145.                 different than all other saved input lines) to the command
  146.                 stack.  This option is most useful if you primarily use the
  147.                 search command to find past input.
  148.  
  149.        /RD      Disable resident Toddy.  Input requests are ignored by
  150.                 Toddy and passed down the interrupt chain, probably to DOS.
  151.                 This might be useful for using an application which
  152.                 conflicts with Toddy. Toddy is reenabled with the /RE
  153.                 option.
  154.  
  155.        /RE      Enable resident Toddy.  This reverses the effects of the
  156.                 /RD option.
  157.  
  158.        /RS      Send options to resident Toddy.  This is used to send
  159.                 options to Toddy after it has already been installed.  Some
  160.                 options (namely /ST) can only be set during installation.
  161.  
  162.        /SExxxx  Entry cursor scan pattern.  This allows the manipulation of
  163.                 the hardware cursor each time Toddy starts to input a line.
  164.                 The first byte of the 16 bit value is the starting cursor
  165.                 scan line and the second byte is the ending cursor scan
  166.                 line.  MDA cursors have 14 scan lines (numbered 0 to 13),
  167.                 CGA cursors have 8, EGA cursors have 14, and VGA cursors
  168.                 have 16.  If bit 13 of the value is set (i.e. /SE2000), the
  169.                 cursor is disabled.
  170.  
  171.        /SN      No cursor scan manipulation.  This disables the /SE and /SX
  172.                 options.  This the default.
  173.  
  174.        /SXxxxx  Exit cursor scan pattern.  This allows the manipulation of
  175.